Software at a site	Software by category	Facilities at a site	Login
You are not logged in
Legend ::     Generic (all NCI systems)       Version specific (all NCI systems)       Host and version specific
CSIRO ASC -> Jumpshot -> Jumpshot 4 - ac

Jumpshot 4 - ac

What is Jumpshot	Jumpshot can be used to profile MPI code on the Altix cluster. It is part of the MPICH MPI implementation but can interface with other MPIs, in particular, with the SGI MPI. The relevant mpe libraries must be linked with your code at compile time. The program is then run under the usual queueing system with an environment variable set to ensure that the log file is created in the correct format. A log file is generated which can then be read by Jumpshot. The graphical viewer is based on Java and may need to be run as an interactive batch job to access sufficient memory.
How to Use Jumpshot on ac	Jumpshot has only been built with the INTEL8 compiler so far and the following instructions are for using Jumpshot with MPI code using the SGI MPI. At this stage jumpshot works for short MPI jobs but may not be able to handle large log files from longer MPI jobs. To use Jumpshot you need to load the jumpshot module and the intel-fc module. To create a logfile from an MPI program do icc prog.c -L$JUMPSHOT_LIB -llmpe -lmpe -lmpi -lm for C programs and ifort prog.f -L$JUMPSHOT_LIB -lmpe_f2cmpi -llmpe -lmpe -lmpi for Fortran programs. Then > prun -n 4 ./a.out which creates the logfile Unknown.clog for Fortran code and a.out.clog for C code. These can then be loaded into jumpshot. A sample job script for running a code for profiling is as follows #!/bin/csh #PBS -wd #PBS -q normal #PBS -l walltime=00:15:00,vmem=1800MB,ncpus=4,jobfs=100Mb module load jumpshot prun -n 4 a.out Running jumpshot may need to be done as a batch interactive job qsub -q express -lwalltime=00:15:00,vmem=800Mb -wd -I -v DISPLAY > .... > module load jumpshot > jumpshot Unknown.clog When jumpshot first starts you will need to convert the clog file to an slog2 file. Click yes then Convert then Return when the transformation is done. You will then see a timeline for each processor. If there is a lot of communication this first display will combine data to give average time spent in different MPI calls in various blocks of time. To see the overall load average right click and drag the cursor from the beginning to the end of the timeline. On release you will get a box entitled "Duration Information Box". Click on Statistics to investigate the load balance of the program. Closing the Duration information box returns the cursor to the timelines. To zoom in on sections of the timeline left click in the region of interest. Continue left clicking until you get sufficient detail. Zooms can be reversed by holding the shift key and left clicking. Detailed information can be obtained by right clicking on arrows or blocks of colour. Using Jumpshot generates some Java errors which can be ignored. They should disappear with later installations.
Software Userguide	There is a Jumpshot manual which can be viewed from the HELP menu option when you start jumpshot. It is rather technical and detailed.
Metadata for using Jumpshot on ac	This section is queriable by XML and used in grid and portal development.Please ensure you fill in the section carefully. Environment for: Queueing system resource request: Module Name: Required batch script entry: Serial program available:              Serial execution prefix: Parallel program available:              Parallel execution prefix:                       Max cpus: Local Scratch required in Script: Environment for: Queueing system resource request: Module Name: Required batch script entry: Serial program available:              Serial execution prefix: Parallel program available:              Parallel execution prefix:                       Max cpus: Local Scratch required in Script: Module Name : Grid Enabled : License Info : Commercial VO list :
XML Query for Jumpshot on ac	You can query this information from an XML server. The queries can be constructed in several ways. this version on this system all versions on this system all versions at this site You may also want to search for this software around APAC. Examples include: this specific version at all NCI sites all versions at all sites See our XML software query help pages for more details.